home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / turbovis / tvtoyc01.zip / README.TXT < prev    next >
Text File  |  1994-01-20  |  18KB  |  493 lines
  1.  
  2.                                 TVToyc
  3.                               Prerelease
  4.                              January 1994
  5.  
  6.                          Far Niente Productions
  7.  
  8.  
  9.  
  10.     Prerelease Information  ▄
  11.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  12.     This is the current status of the TVToyc project, a port of the
  13.     TVToys (for Pascal) package.  I dislike BC a lot, and I don't know
  14.     enough C or C++ to do this justice.  Without your help, TVToyc will
  15.     be buried and forgotten for good, so try to improve it, volunteer to
  16.     port more code (it's dead boring, but very easy) or at least let me
  17.     know if you liked it.
  18.  
  19.     Without user support this project is dead.
  20.  
  21.  
  22.  
  23.     Contents  ▄
  24.   ▀▀▀▀▀▀▀▀▀▀▀▀▀
  25.     Introduction
  26.     Copyright
  27.     Short Description
  28.     Package File List
  29.  
  30.     Instructions
  31.     Compatibility Testing
  32.     Coding Style
  33.     Protected Mode Information
  34.     Overlay Information
  35.     PC Video Modes
  36.     Video 7
  37.  
  38.     The Improved Help File
  39.     Extended Video Mode Support Code
  40.  
  41.     Credits
  42.     Author, Support, Info, Bugs etc
  43.     To Do List
  44.  
  45.  
  46.  
  47.     Introduction  ▄
  48.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  49.     Welcome to TVToyc!
  50.  
  51.     This is a collection of useful stuff that should be available to all
  52.     Turbo Vision programmers. It is intended for Borland C++ 3.x with
  53.     Turbo Vision but the [font, palette] and video mode code can be used
  54.     in plain text mode without Turbo Vision.
  55.  
  56.     THE SOURCE IS FREE AND COMES WITH NO WARRANTIES WHATSOEVER.
  57.  
  58.     I hope that you will find this package useful. Have fun with it!
  59.  
  60.  
  61.  
  62.     Copyright  ▄
  63.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  64.     You may use this package for free and pass it on to other persons as
  65.     long as you clearly state, in the header as well as in the code, all
  66.     changes made to the original code.
  67.  
  68.     You may not pass along compiled versions of the source, except as
  69.     executable files.
  70.  
  71.     You may also upload this package, unmodified, to bulletin boards or
  72.     other public access places.
  73.  
  74.     There must be no charge associated with this package, though you may
  75.     include the unmodified package as a whole in shareware/freeware
  76.     compilations if only a nominal amount is charged for the compilation
  77.     disk.
  78.  
  79.     I strongly urge people with money to spare to donate a small token
  80.     of appreciation in the $20 range. That's 5 campus meals for me.
  81.  
  82.  
  83.  
  84.     Short Description  ▄
  85.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  86.     This package includes:
  87.  
  88.     An improved Help viewer with back tracking and the possibility to
  89.     add Contents and Index pages or whatever without recompiling
  90.     the help engine.
  91.  
  92.     Extended video mode support. Code that determines what video modes
  93.     are available and presents a list for the user to choose from.
  94.     Video7 and VESA support included.
  95.  
  96.  
  97.     WHAT THIS PACKAGE COULD INCLUDE:
  98.  
  99.     Custom fonts. Support for three different font file formats.
  100.  
  101.     Palette routines. Change the EGA/VGA palette.
  102.  
  103.     A mouse unit that limits the effects of buggy mouse drivers in
  104.     extended video modes.
  105.  
  106.     Three demonstration programs, personal configuration files.
  107.  
  108.  
  109.  
  110.     Package File List  ▄
  111.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  112.     The package consists of the following files:
  113.  
  114.     TEST.CPP      Main test program
  115.     TEST.MAK      Attempt at make file for TEST.CPP
  116.  
  117.     HELP.H
  118.     HELP.CPP
  119.     HELPBASE.H
  120.     HELPBASE.CPP  Improved HelpFile with back tracking and external commands
  121.  
  122.     HELPCTX.H     Help contexts generated by TVHC
  123.     HELPTEST.HLP  Demo help text compiled with TVHC
  124.     HELPTEST.TXT  The Help text source
  125.  
  126.     VIDEO.H
  127.     VIDEO.CPP     A unit supporting extended video mode setting and searching
  128.  
  129.     MODEDLG.H
  130.     MODEDLG.CPP   Dialog for presenting and selecting video modes
  131.  
  132.     TVVIDEO.H
  133.     TVVIDEO.CPP   TV support for all the new video modes
  134.  
  135.     TOYCFG.H      Your personal configuration file
  136.  
  137.     VESA.H
  138.     VESA.CPP      VESA support routines
  139.  
  140.     README.TXT    This text.
  141.  
  142.  
  143.  
  144.     Instructions  ▄
  145.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  146.     The demonstration program relies on the improved help code included
  147.     in this package, so you should make sure it gets used instead of
  148.     Turbo Vision's normal help engine.
  149.  
  150.     The program called TEST is a very simple demonstration of the help
  151.     and the video mode detection. Run it for a quick demonstration.
  152.  
  153.     If your mouse behaves oddly at times when running TEST, you need
  154.     NEWMOUSE, a not yet ported mouse remedy against bug ridden mouse
  155.     drivers.
  156.  
  157.     The mouse cursor also jumps around when you change video modes, but
  158.     that's because the cursor stays at the same position relative to the
  159.     upper left corner.
  160.  
  161.     Convention:  Uppercase words are file names, like TEST and TOYCFG. A
  162.                  "section" is a paragraph in this file, having the
  163.                  section name for header.
  164.  
  165.  
  166.  
  167.     Compatibility Testing  ▄
  168.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  169.     This code has mainly been tested on three machines:
  170.  
  171.       ■ A 286 with with a Chips VGA card and an EGA monitor. Also tested
  172.         with a Video7 card which provided 132 column output on the EGA
  173.         monitor. No protected mode. First development machine.
  174.  
  175.       ■ An IBM PS/1 486/33 with Tseng VGA chips. VERY slow at scanning.
  176.         First protected mode attempts.
  177.  
  178.       ■ A Dual monitor Compaq 386 Portable with a Video7 VGA card and
  179.         Super VGA monitor. Current development platform.
  180.  
  181.     I have tested three mouse drivers on the Video 7 equipped 386:
  182.     Microsoft Mouse driver version 8.20 and earlier does not work with
  183.     extended text modes, it assumes them to be graphics modes. All
  184.     Logitech mouse drivers should work with all text modes, I have only
  185.     tested version 6.20. Genius mouse driver version 10.20 does not
  186.     work, it doesn't realize what width the screen is. NewMouse fixes
  187.     all this, but if the mouse driver is buggy (like Genius) there might
  188.     be minor annoyances like the cursor jumping or temporarily
  189.     disappearing at mode switches. I suggest that you check what mouse
  190.     driver you are using, there are usually several on every hard disk.
  191.     I use Microsoft's driver version 8.20 even though it's buggy, but
  192.     you know what you get.
  193.  
  194.     VESA compatibility was tested using a PD Video7 TSR on the 386.
  195.  
  196.     UNIVESA.EXE by Kendall Bennett is NOT a full VESA implementation, it
  197.     focuses solely on graphics video modes and will not provide the
  198.     necessary information to avoid having to physically test every video
  199.     mode.
  200.  
  201.     If you promptly have to use UNIVESA or UNIVBE release 4.2 or earlier
  202.     on a Video 7 video card, make sure you define V7UniVesaKludge, since
  203.     there is a Video 7 specific bug in UNIVESA. Future versions of
  204.     UNIVESA will probably not suffer from this.
  205.  
  206.  
  207.  
  208.     Coding Style  ▄
  209.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  210.     I'm a C++ novice, and the source is a Pascal port with some changes
  211.     on the way.  If you have suggestions or even better rewritten code
  212.     I'll be happy to see it.  I admit the current version could be a lot
  213.     better.
  214.  
  215.  
  216.  
  217.     Protected Mode Information  ▄
  218.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  219.     All the code has been tested in protected mode, especially the
  220.     Video7, Vesa and NewMouse code, but only in the Pascal version.
  221.  
  222.     I have not ported the protected mode code since I lack information
  223.     on BC Dos extenders, and I don't have a Dos extender for BC++, so I
  224.     couldn't test it anyway. I've left the Pascal DPMI implementation if
  225.     you feel inclined.
  226.  
  227.  
  228.  
  229.     Overlay Information  ▄
  230.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  231.     You can overlay all units EXCEPT NewMouse, which contains an
  232.     interrupt handler. It's a very small unit anyway, about 530 bytes.
  233.  
  234.  
  235.  
  236.     PC Video Modes  ▄
  237.   ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  238.     Turbo Vision only knows about three video modes, and there is a
  239.     reason for that. These three are the only "standard" 80 column text
  240.     modes, all other video modes are manufacturer specific. All modes
  241.     are referred to by number, and the three Turbo Vision knows about
  242.     are number 2, 3 and 7. Numbers range from 0 to 127, where most of
  243.     the